home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / networking / amitcp / amitcp-bin-20.lha / AmiTCP-2.0 / README.FIRST < prev   
Encoding:
Text File  |  1993-08-15  |  7.6 KB  |  211 lines

  1. * Copyrights
  2.  
  3.   See the file `COPYRIGHTS' for the copyright information of the
  4.   AmiTCP/IP and included material.
  5.  
  6. * License
  7.  
  8.   The GNU General Public License version 2 (see the file `COPYING')
  9.   applies to the whole distribution, except for files explicitly
  10.   stated in the file `COPYRIGHTS'.
  11.  
  12. * This Release
  13.  
  14.   We still consider the release 2 (version 2.0) as a `beta' version,
  15.   that is, there might still be some bugs left and some details will
  16.   certainly change.
  17.  
  18. * How to Contact the Authors?
  19.  
  20.   Authors of the AmiTCP/IP can be reached from the e-mail address
  21.  
  22.     AmiTCP-Group@hut.fi
  23.  
  24.   The e-mail address for bug reports is:
  25.  
  26.     AmiTCP-Bug@hut.fi
  27.  
  28.   There is also a mailing list for the developers, AmiTCP@hut.fi. You
  29.   can join it by sending a request to:
  30.  
  31.     AmiTCP-Request@hut.fi
  32.  
  33.   Please include a word `ADD' along with your mail address in a single
  34.   line in your message body.
  35.  
  36.   Any problems and suggestions can also be discussed in the newsgroup
  37.   comp.sys.amiga.datacomm.
  38.  
  39. * About the FTP and Telnet Clients
  40.  
  41.   The FTP and Telnet clients included in the binary distribution are
  42.   supplied by:
  43.  
  44.     Mark Tomlinson <mark@garden.equinox.gen.nz>
  45.     Goeff McCaughan <geoff@equinox.gen.nz>
  46.  
  47.   You are should send your comments about FTP and Telnet to them.
  48.  
  49.   Source code for these two programs can be found from the Aminet
  50.   under the directory comm/net.
  51.  
  52. * How to Install AmiTCP/IP:
  53.  
  54.   You should not install the current version on top of any older
  55.   version.  If your disk space allows, leave the old version on the
  56.   disk and delete it when you have the new version up and running.
  57.   
  58.   Extract first the distribution archives (AmiTCP_xxx_20.lha) to some
  59.   directory in your hard disk (e.g. WORK:).
  60.   
  61.   Before you proceed, you should get the following information from
  62.   your network administration (if you don't have the information, you
  63.   have to modify your network database afterwards):
  64.   
  65.   * Internet protocol address for your computer. This is a 32 bit
  66.     integer represented as a series of decimal numbers separated by
  67.     dots. For example, 130.233.161.40 is a legal internet address.
  68.  
  69.   * If you have a point-to-point connection to the network, you need
  70.     to know your destination IP address, that is the IP address of
  71.     the host you are connected. SLIP, CSLIP and PPP are examples of
  72.     point-to-point connections.
  73.   
  74.   * Netmask for your network. This specifies how many bits of your
  75.     internet address are used to specify the network address. Netmask
  76.     is like 255.255.255.0. If your network is not sub-netted, then do
  77.     not have to supply this value (a default computed from the IP
  78.     address is used).
  79.   
  80.   * Address of the default gateway. If your host do not know any route
  81.     to a host it resorts to the default gateway. If you have only one
  82.     point-to-point connection, you should use the host you are
  83.     connected as a default gateway.
  84.   
  85.   * Your host name. Host name is a more convenient way than the internet
  86.     address to refer your computer. This is like `Amiga1'.
  87.   
  88.   * Domain name of your site. For example, "hut.fi" is the domain name
  89.     for the Helsinki University of Technology in Finland. The part
  90.     after the first dot in your full host name is usually (but not
  91.     always) your domain name.
  92.   
  93.   * Addresses of the Domain Name Servers which will be used to
  94.     translate host names to the corresponding internet addresses. A
  95.     local database must be used instead if there is no name server on
  96.     your domain.
  97.   
  98.     If you have an access to a Unix machine in your network, you can
  99.     probably find a list of domains and name server addresses in the
  100.     file `/etc/resolv.conf'. Also, if there is no name server, you can
  101.     copy the file `/etc/hosts' to the `AmiTCP:db/hosts'.
  102.  
  103.   Next you should obtain a SANA-II compatible device driver for your
  104.   network adapter. The SANA-II drivers are usually installed into
  105.   directory `DEVS:networks'. We have included a few freely
  106.   distributable drivers with the AmiTCP/IP. You can use the SLIP or
  107.   CSLIP drivers with a serial interface.
  108.  
  109.   AmiTCP/IP uses the name of SANA-II device driver to access it. You
  110.   should also know the number of unit you are using (usually 0). You
  111.   might also have to make a configuration file for your device driver.
  112.   The configuration files have usually the name of the interface
  113.   appended with unit number and `.config', e.g. unit 1 of sana.device
  114.   uses the configuration file `slip1.config'.  Configuration files are
  115.   usually stored into the directory `ENV:Sana2/'.
  116.   
  117.   You may start the installation by double-clicking the
  118.   "Install_AmiTCP-2.0"-icon.
  119.   
  120. * What Happens in the Installation?
  121.   
  122.   The course of installation is shortly explained for those of you who
  123.   want to know what happens to their computer:
  124.  
  125.   * Amount of free memory and version of system software is checked
  126.   * Destination directory is asked for
  127.   * An earlier installation is checked in the destination directory,
  128.     so you can change your setup by running the installation script
  129.     again
  130.   * The AmiTCP/IP files are copied to the destination if needed
  131.   * Included Sana-II device drivers are installed
  132.   * EmacsTCP is installed 
  133.   * NapsaTerm is installed
  134.   * You are queried some information concerning your network setup:
  135.     * Your host and domain name name is stored to the environment
  136.       variable HOSTNAME
  137.     * You are asked for aliases (nicknames) for your host
  138.     * You are asked for the name, unit of the interface you are using
  139.     * Likewise the interface (and destination) IP addresses and
  140.       netmask are asked
  141.     * You are asked for the IP address of the default gateway
  142.     * You are asked for domain names and domain name server IP
  143.       addresses
  144.   * If you select to start AmiTCP/IP when your computer boots,
  145.     appropriate command is added to your s:user-startup.
  146.   * S:user-startup is modified to make right assigns and paths.
  147.   * Installer creates Amitcp:bin/startnet, a script to start
  148.     AmiTCP/IP, configure Sana-II interfaces and provide basic routing
  149.   * Other network information is saved in the file
  150.     AmiTCP:db/netdb-myhost
  151.  
  152. * If There Is Some Problems with Installation 
  153.   
  154.   Here is an example of the required information:
  155.  
  156.     Name of your computer:             slip-2
  157.     Your domain part:             hut.fi
  158.     Aliases for it:             amy
  159.     Your Internet address:             130.233.161.50
  160.     Destination address (terminal server):    130.233.161.90
  161.     Netmask of used in your network:    255.255.252.0
  162.     Address of the default gateway:     130.233.163.254
  163.     Domain names to search:            hut.fi
  164.                         cs.hut.fi
  165.     Addresses of nameservers:         130.233.224.1
  166.                         130.233.224.13  
  167.                         128.214.4.29
  168.     SANA-II device driver:             slip.device 
  169.         (Serial Line IP)
  170.     Unit of the SANA-II device driver:     0 
  171.  
  172.    
  173.   `AmiTCP:bin/StartNet' (lines beginning with `;' are comments):
  174.  
  175.     run AmiTCP:AmiTCP
  176.     SYS:Rexxc/WaitForPort AMITCP
  177.     Wait 2 secs
  178.     ; configure loop-back device
  179.     AmiTCP:bin/ifconfig lo/0 localhost
  180.     ; Configure Devs:Networks/slip.device unit 0
  181.     AmiTCP:bin/ifconfig Devs:Networks/slip.device/0 130.233.161.50 +
  182.     130.233.161.90 netmask 255.255.252.0
  183.     ; Add route to this host
  184.     AmiTCP:bin/route add slip-2.hut.fi localhost
  185.     ; Add route to the default gateway
  186.     AmiTCP:bin/route add default 130.233.163.254
  187.     ; Start the internet `super server'
  188.     run AmiTCP:bin/inetd
  189.  
  190.   `Amitcp:db/netdb-myhost' (lines beginning with `;' are comments):
  191.  
  192.     ; This host
  193.     HOST 130.233.161.50 slip-2.hut.fi slip-2 amy
  194.     ; Domain names
  195.     DOMAIN hut.fi
  196.     DOMAIN cs.hut.fi
  197.     ; Name servers
  198.     NAMESERVER 130.233.224.1
  199.     NAMESERVER 130.233.224.13
  200.     NAMESERVER 128.214.4.29
  201.  
  202.   `S:User-Startup' will contain something along following lines (if
  203.   you do not choose to start AmiTCP at the system startup):
  204.   
  205.     ;BEGIN AmiTCP/IP
  206.     setenv HOSTNAME slip-2.hut.fi
  207.     assign AmiTCP: HardDisk:Work/project/DIST-2.0.24
  208.     path AmiTCP:bin add
  209.     ;END AmiTCP/IP
  210.  
  211.